home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / ps.man < prev    next >
Encoding:
Text File  |  1989-08-10  |  9.2 KB  |  267 lines
  1.  
  2.  
  3.  
  4. PS                        User Commands                        PS
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      ps - print process status information
  12.  
  13. SSYYNNOOPPSSIISS
  14.      ppss [_o_p_t_i_o_n(_s)] [_p_i_d _p_i_d ...]
  15.  
  16. OOPPTTIIOONNSS
  17.      --aa            Print out information for processes  belonging
  18.                    to  all  users  (normally  only  the  invoking
  19.                    user's processes are printed).
  20.  
  21.      --AA            Print  out  information  for  absolutely   all
  22.                    processes, even dead ones.
  23.  
  24.      --dd            Print information only for processes in  DEBUG
  25.                    state.
  26.  
  27.      --hheellpp         Print out a  help  message  and  exit  without
  28.                    doing anything else.
  29.  
  30.      --ii            Instead of  the  default  status  information,
  31.                    print  information  about  various process ids
  32.                    (includes the PID, PPID, GROUP,  USER,  RUSER,
  33.                    TIME, and COMMAND fields).
  34.  
  35.      --kk            Print  out  information  for   kernel   server
  36.                    processes  in  addition to any other processes
  37.                    requested with other switches.
  38.  
  39.      --ll            Use local information for  migrated  processes
  40.                    rather  than  following  them to their current
  41.                    hosts.
  42.  
  43.      --mm            Print information only for processes that  are
  44.                    migrated to or from another machine.
  45.  
  46.      --MM            Instead of  the  default  status  information,
  47.                    print   information  about  process  migration
  48.                    (includes the PID, STATE, FLAGS, EVENT, RNODE,
  49.                    RPID, and COMMAND fields).
  50.  
  51.      --ss            Instead of  the  default  status  information,
  52.                    print  information about signals (includes the
  53.                    PID, PENDING, HELD, IGNORE, HANDLE,  and  COM-
  54.                    MAND fields).
  55.  
  56.      --uu            Instead of  the  default  status  information,
  57.                    print  additional  ``user-oriented''  informa-
  58.                    tion, including PID, %CPU,  %MEM,  SIZE,  RSS,
  59.                    STATE, TIME, PRI, and COMMAND.
  60.  
  61.  
  62.  
  63. Sprite v.1.0        Printed:  August 10, 1989                   1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PS                        User Commands                        PS
  71.  
  72.  
  73.  
  74.      --vv            Instead of  the  default  status  information,
  75.                    print virtual memory information (includes the
  76.                    PID, CODSZ, CODRS, HPSZ, HPRS,  STKSZ,  STKRS,
  77.                    SIZE, RSS, and COMMAND fields).
  78.  
  79.      --ww _l_i_n_e_W_i_d_t_h  Use _l_i_n_e_W_i_d_t_h as the output line  length,  and
  80.                    format  output so that it fits neatly on lines
  81.                    of this length.  The COMMAND field gets  trun-
  82.                    cated as necessary to accomplish this.
  83.  
  84. _________________________________________________________________
  85.  
  86.  
  87. DDEESSCCRRIIPPTTIIOONN
  88.      This command prints out process status information.  If  one
  89.      or  more  _p_i_d's  is  given,  then information is printed for
  90.      those processes.  If no _p_i_d is given,  then  information  is
  91.      printed  for  all  processes  belonging to the invoking user
  92.      (additional processes may be requested  with  switches  like
  93.      --aa).
  94.  
  95.      By default, ppss prints a short status report  for  each  pro-
  96.      cess,  containing  the PID, STATE, TIME, and COMMAND fields.
  97.      Other forms of printout are available using switches like --uu
  98.      and --mm.
  99.  
  100.  
  101. FFIIEELLDDSS
  102.      The names of fields printed by ppss (which appear at the  tops
  103.      of  the  columns  of  ppss  printout),  and the meaning of the
  104.      information printed in the fields, are:
  105.  
  106.      CCOODDRRSS        The amount of physical memory occupied by  this
  107.                   process's code segment, in units of 1024 bytes.
  108.  
  109.      CCOODDSSZZ        The total size of this process's code  segment,
  110.                   in  units  of  1024  bytes.  Not all of this is
  111.                   necessarily resident in memory.
  112.  
  113.      CCOOMMMMAANNDD      The command  that  the  process  is  executing.
  114.                   This field gets truncated if necessary to avoid
  115.                   running off the end of the line.   Use  the  --ww
  116.                   switch  to  request  a  longer  line  size when
  117.                   needed.
  118.  
  119.      EEVVEENNTT        The _e_v_e_n_t field from the process control  block
  120.                   (printed in hexadecimal).  See the include file
  121.                   <kernel/proc.h> for further information.
  122.  
  123.      FFLLAAGGSS        The _g_e_n_F_l_a_g_s field  from  the  process  control
  124.                   block   (printed   in  hexadecimal).   See  the
  125.                   include file <kernel/proc.h> for further infor-
  126.                   mation.
  127.  
  128.  
  129.  
  130.  
  131. Sprite v.1.0        Printed:  August 10, 1989                   2
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138. PS                        User Commands                        PS
  139.  
  140.  
  141.  
  142.      GGRROOUUPP        The  process  group  to  which   this   process
  143.                   belongs.
  144.  
  145.      HHAANNDDLLEE       A hexadecimal value giving a  bit-mask  of  the
  146.                   signals  for  which  the  process has specified
  147.                   handler procedures.
  148.  
  149.      HHEELLDD         A hexadecimal value giving a  bit-mask  of  the
  150.                   signals   currently  ``held''  (prevented  from
  151.                   being delivered to the process at its request).
  152.  
  153.      HHPPRRSS         The amount of physical memory occupied by  this
  154.                   process's heap segment, in units of 1024 bytes.
  155.  
  156.      HHPPSSZZ         The total size of this process's heap  segment,
  157.                   in units of 1024 bytes.
  158.  
  159.      IIGGNNOORREE       A hexadecimal value giving a  bit-mask  of  the
  160.                   signals currently being ignored by the process
  161.  
  162.      PPIIDD          The process ID for the process.
  163.  
  164.      PPPPIIDD         The process id of the parent of this process.
  165.  
  166.      PPRRII          The priority of the  process.   Processes  with
  167.                   normal   priority  have  no  specific  priority
  168.                   listed.  Server processes, with infinite prior-
  169.                   ity,  are  listed as "S". Processes with above-
  170.                   normal  priority  are  listed   as   ">",   and
  171.                   processes with below-normal priority are listed
  172.                   as "<".  Processes with  VERY_LOW_PRIORITY  are
  173.                   listed as "<<".
  174.  
  175.      PPEENNDDIINNGG      A hexadecimal value giving a  bit-mask  of  the
  176.                   signals  that are awaiting delivery to the pro-
  177.                   cess.
  178.  
  179.      RRNNOODDEE        For a migrated  process,  this  identifies  the
  180.                   ``other'' node that the process belongs to (its
  181.                   home node if this is the remote node,  or  vice
  182.                   versa).
  183.  
  184.      RRPPIIDD         For a migrated process, this contains the id of
  185.                   the  process  on  its  ``other'' node (its home
  186.                   node if  this  is  the  remote  node,  or  vice
  187.                   versa).
  188.  
  189.      RRSSSS          Resident set size:  the total  physical  memory
  190.                   occupied  by  this  process,  in  units of 1024
  191.                   bytes.  This is the sum  of  CODRS,  HPRS,  and
  192.                   STKRS.
  193.  
  194.  
  195.  
  196.  
  197. Sprite v.1.0        Printed:  August 10, 1989                   3
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204. PS                        User Commands                        PS
  205.  
  206.  
  207.  
  208.      RRUUSSEERR        The name of the user corresponding to the  real
  209.                   user ID of this process.
  210.  
  211.      SSIIZZEE         The total amount of virtual memory allocated to
  212.                   this  process, in units of 1024 bytes.  Not all
  213.                   of this memory is necessary resident in  physi-
  214.                   cal  memory,  and  some of it may not even have
  215.                   been accessed.  SIZE is equal  to  the  sum  of
  216.                   CODSZ, HPSZ, and STKSZ.
  217.  
  218.      SSTTAATTEE        The current execution state of the process.
  219.  
  220.      SSTTKKRRSS        The amount of physical memory occupied by  this
  221.                   process's  stack  segment,  in  units  of  1024
  222.                   bytes.
  223.  
  224.      SSTTKKSSZZ        The total size of this process's heap  segment,
  225.                   in units of 1024 bytes.
  226.  
  227.      TTIIMMEE         The total CPU time consumed by the process,  in
  228.                   minutes  and  seconds.  This time includes both
  229.                   kernel and user time.
  230.  
  231.      UUSSEERR         The user name corresponding  to  the  effective
  232.                   user ID of this process.
  233.  
  234.      %%CCPPUU         A smoothed average of the  fraction  of  a  CPU
  235.                   that  this  process  has consumed over the last
  236.                   several seconds.
  237.  
  238.      %%MMEEMM         The fraction of total physical memory  occupied
  239.                   by  this  process's segments.  Does not include
  240.                   memory that  belongs  to  the  process  but  is
  241.                   swapped out.
  242.  
  243.  
  244. KKEEYYWWOORRDDSS
  245.      process, status
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263. Sprite v.1.0        Printed:  August 10, 1989                   4
  264.  
  265.  
  266.  
  267.